home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / UTILITY / MBOOT320.ARJ / MBOOT.DOC < prev    next >
Text File  |  1991-12-05  |  19KB  |  416 lines
  1.  
  2.  
  3.  
  4.         (c)1991 Programming Constructs - Damion Haux
  5.                   MultiBoot Version 3.20
  6.  
  7.  
  8.  
  9.  
  10. ---------------------------------------------------------------------------
  11.      Copyright (c) 1990,1991  Damion Haux   ALL RIGHTS RESERVED
  12.     
  13. You have a 30 day trial period to try out and use this program.  If you
  14. use it after that, send 10$ to :
  15.  
  16.      Damion Haux
  17.      576 E. 16th
  18.      Eugene, OR 97401
  19.  
  20. The unregistered version will allow up to 15 configs, the registered will
  21. support 99.  The registered version also shows you and all your friends
  22. that you support sharware authors.  Please register your copy of the program.
  23.  
  24. SYNOPSIS
  25. --------
  26.         MBOOT [config name] [/R] [/M] [/Tx]
  27.       or
  28.         MBOOT /C
  29.     
  30.     where
  31.                 CONFIG NAME is the desired configuration name
  32.                 this is optional, and the program will behave
  33.                 differently according to your flags (explained below)
  34.  
  35.                 /R forces a reboot after the new config is copied
  36.                    whether your ${AC} flag is set or not. (explained below)
  37.  
  38.                 /M *** this option removed for version 3.13 ***
  39.  
  40.                /Tx where x is any number from 1-39 seconds.  This is the delay
  41.                    before the program reboots.  This is specifically for
  42.                    people using disk caches that buffer writes.  Set this so
  43.                    the cache has time to flush itself before the machines reboots.
  44.                    (can be set in MBOOT config)
  45.  
  46.                 /C all by itself will bring up the configuration section
  47.                    of the program which allows permanent setting of
  48.                    any of the four flags, and setting of the colors
  49.                    used in the program.  It also allows setting of the
  50.                    path where the config files will be copied.
  51.  
  52. DESCRIPTION
  53. -----------
  54.    This program will keep a data file containing up to 99 different
  55. configuration sets (in the registered version) and 15 configs (for the
  56. shareware version) containing an AUTOEXEC.BAT and a CONFIG.SYS for
  57. that option.  You may then use control flags to either copy a default
  58. when there are no command line parameters, or put up a point and shoot
  59. selection screen.  If you specify a config on the command line, the program
  60. will do one of three things:
  61.     1. If the requested setup is found in the config file, it will be
  62.        used.
  63.     2. If the requested setup isn't found, and the {$UM} 'Use Match' flag
  64.        is set, the program will search for the closest match to the name
  65.        you asked for.
  66.     3. If the requested setup isn't found, and the {$UM} flag isn't set,
  67.        the selection screen will be displayed.  At that point you can
  68.        either choose a config, or press [ESC] to abort.
  69.  
  70. Control flags will be explained below in the section entitled "Control
  71. Flags" (pretty intuitive, eh?).  The files MBOOT.EXE and MBOOT.CFG can be
  72. in any directory.  MBOOT.EXE will either copy the config files to the
  73. default directory, or to the directory specified in the setup screen
  74. if the COPY_ROOT flag is set (see flags below)
  75.         
  76. ERROR MESSAGES
  77. --------------
  78. MBOOT.CFG not found     - The file MBOOT.CFG is not in the same directory
  79.                           as the program MBOOT.EXE.
  80.  
  81. Cannot find BOF         - The file pointer cannot be reset to the beginning
  82.                           of the MBOOT.CFG file.  Could be if you have more
  83.                           than 100 configs in the file.
  84.  
  85. Error reading MBOOT.CFG - There is a problem reading MBOOT.CFG.  Could be
  86.                           because the file is damaged, or...?
  87.  
  88. Cannot open window      - Not enough memory to open the window.  Free up
  89.                           some memory.
  90.  
  91. Cannot find editor      - The editor specified in the config cannot be found
  92.                           where it should be.
  93.  
  94. Not enough memory       - With MBOOT.EXE still in memory and a secondary
  95.                           command.com loaded, MBOOT takes up approx. 164k of
  96.                           memory.  I am going to be integrating Marty Del
  97.                           Veccio's SWAP utility soon, which should leave much
  98.                           more memory available for the user editor.
  99.  
  100. MBOOT Configuration
  101. -------------------
  102.   ╔════════════════════════════════════════════════════════════════════════╗    
  103.   ║                [ Mono Defaults ]                                       ║    
  104. 1 ║   Border Back  0     0                 1       Foregound               ║
  105. 2 ║   Border Fore  2     2        123456789012345    Colors                ║
  106. 3 ║   Window Back  0     0        ***************                          ║
  107. 4 ║   Window Fore  2     2               1   Background                    ║
  108. 5 ║      Bar Back  0     0         1346891   Colors                        ║
  109. 6 ║      Bar Fore  112   112      06284062           ╔══════════════════╗  ║
  110. 7 ║   Use Default  N              ********           ║  Window text     ║  ║
  111. 8 ║  Copy to Path  N                                 ║  Selection Bar   ║  ║
  112. 9 ║  Force Reboot  N                                 ║  Window text     ║  ║
  113. 10║ Use BestMatch  N                                 ╚══════════════════╝  ║
  114. 11║   Target Path  C:\                                   Sample Window     ║
  115. 12║   Editor Path  C:\youreditor                                           ║
  116. 13║     Work Path                                                          ║
  117. 14║  Make backups  N                                                       ║
  118. 15║  Reboot Delay  3  < 35                                                 ║
  119. 16║   Reboot Prog                                                          ║
  120. 17║   Reboot Type  W  (W)arm, (C)old, (X)custom                            ║
  121.   ╚════ [Ctrl-Enter]=Finished ═════════════════ [Esc]=Abort ═══════════════╝    
  122.  
  123. By running MBOOT with the \c parameter, the program can be configured.
  124. In items 1 thru 6, you can choose a number from the color chart at right.
  125. Remember that you should only use background colors in background fields
  126. and foreground colors in foreground fields.  However, you may get some
  127. interesting effects otherwise.
  128.      7 controls whether the program will use your default setting if
  129.        no config is specified on the command line.
  130.      8 controls whether the new AUTOEXEC and CONFIG will be copied to
  131.        the default drive, or to the path specified in config options 11.
  132.      9 will cause the program to do a warm reboot after the new config
  133.        is copied.
  134.      10 controls whether the program will try to get a best match on
  135.         a partial config name.
  136.      11 is the path where the new config files will be copied.
  137.      12 is the complete path to your editor.  The editor will be called
  138.         with a file name after it to edit.
  139.      13 is the path where temporary edit files are kept and edited.
  140.      14 is Y or N, if you specify Y, two backup files will be made of your
  141.         old CONFIG.SYS and AUTOEXEC.BAT before the program overwrites them.
  142.      15 is the number of seconds you would like the program to wait before
  143.         it reboots.  Useful for flushing caches.
  144.      16 is the complete path to your custom boot program if the built in
  145.         boot routine does not work correctly.
  146.      17 specifies whether you want MBOOT to use it's built in (W)arm reboot,
  147.         built in (C)old reboot, or use the (X)custom boot program you specified.
  148.  
  149. - The custom editor has been tested with QEDIT, WORDSTAR 4.0, and the
  150.   NORTON PROGRAM EDITOR.  MBOOT takes 164k of memory.  Everything else
  151.   can be used by your editor.
  152. -----
  153. NOTE: If MBOOT is compressed with LZEXE or PKLITE, it will no longer be
  154. configurable because all the config information is encoded in the EXE file.
  155. It will, however, still run.
  156. -----
  157.  
  158. MBOOT.CFG Organization
  159. ----------------------
  160. The config file MBOOT.CFG is organized as follows.  Somewhere on the first
  161. three lines, you may use any of the CONTROL FLAGS described below.  You must
  162. then organize it such:
  163.  
  164.  +-This is a default line, you need only one.  It must appear in the first
  165.  | three lines of your config file.
  166.  |
  167. ${D} <config name>
  168.  
  169.  +--------These are global autoexec lines.  They will appear as the first
  170.  |        lines in your any new autoexec.  They are used in all the autoexecs
  171.  |        copied to your disk.
  172.  |
  173. $A$ ECHO OFF
  174. $A$ PROMPT $p$g
  175.  
  176.  +--------These are global config lines, see above...
  177.  |
  178.  |
  179. $C$ FILES=20
  180. $C$ BUFFERS=15
  181.  
  182.  +--------Comment lines.  Any line starting with a # character is ignored.
  183.  |
  184.  |
  185. #lines with no apparent meaning
  186. #or importance
  187.  
  188.  +-The rest of the file is organized in groups of three.  The first flag
  189.  | defines the name of the config.  A description follows the semicolon.
  190.  | The line has a maximum length of 128.  It will be shortened to 75 when
  191.  | the selection screen is displayed.
  192.  |
  193. ${N} <config name>            ;<description>      /r
  194.                                                    |
  195.    | New with version 3.06.  If you put------------+
  196.    | a /r after the description, this
  197.    | particular config will ALWAYS reboot.
  198.  
  199. ${C} -----Second flag defines the start of the CONFIG.SYS
  200. ........    -+
  201. ..........   +---- body of config.sys
  202. .......      |
  203. .....       -+
  204. ${A} -----Third flag defines the start of the AUTOEXEC.BAT
  205. ..................  -+
  206. ..........           |
  207. .........            +---- body of autoexec.bat
  208. .......              |
  209. ..............      -+
  210.  
  211. ${N} <config name>           ;<description>
  212.  
  213.  ..and so forth.
  214.  
  215. Instructions for Use
  216. --------------------
  217. As of version 3.0, the following features have been added:
  218. -  Pressing C at the selection menu will call up the editor specified
  219.    in the config to edit the CONFIG.SYS for this option.
  220.  
  221. -  Pressing A at the selection menu will allow you to edit your AUTOEXEC.BAT
  222.    for that option with the user-defined editor.
  223.  
  224. -  Pressing R at the selection menu will allow editing of the highlited configs
  225.    name, description, and reboot status.
  226.  
  227.  
  228. -  Pressing Ins while in the selection screen will allow you to append a new
  229.    config on the end of your file, and you may use the C and A options above
  230.    to edit the new config.
  231.  
  232. -  Pressing Del while in the selection screen will remove the highlited config
  233.    from the data file.
  234.  
  235. -  The two status lines on top are mouse sensitive
  236.  
  237. -  Adding a /r to the end of a name line in the config file will cause
  238.    that config to ALWAYS reboot when chosen.
  239.  
  240. -  The program will now copy three REM lines into your AUTOEXEC.BAT that looks
  241.    like this..
  242.  
  243. REM MultiBoot V 3.0 - Config [ZILCH]  Date [4-29-91]  Time [2:55a]
  244. REM Absolutely nothing
  245. REM ---------------------------------------------------------------
  246.  
  247.    This time stamp can be disabled by using the {SS} flag in the config file
  248.    as described below.
  249.  
  250. 3.12
  251. -  You can type the config number directly in if you don't want to page
  252.    through all your configs.
  253.  
  254. 3.20
  255. -  Pressing D at the selection menu will duplicate the config you are on and
  256.    allow you to give a new name to it.
  257.  
  258. CONTROL FLAGS  (Used only in MBOOT.CFG as described above)
  259. --------------
  260. ${AR}      - Activate reboot.  This option will cause the program to
  261.              reboot after the requested config is copied.  You have
  262.              three seconds (default) to abort the reboot by pressing a key.
  263.  
  264. ${UD}      - Use Default.  This will cause the program to use the
  265.              default setup instead of bringing up the selection screen
  266.              when the command line is empty.
  267.  
  268. ${UM}      - Use match.  The program will use the closest match in the
  269.              config file if it can't find the one you specified.
  270.  
  271. ${CC}      - Copy to the path specified in the configuration.  This is
  272.              initially set to C:\.  If this flag is set, MBOOT will copy
  273.              the new config files to C:\, otherwise they end up in the default
  274.              directory.  Of course, MBOOT must be in the path somewhere.
  275.              You can change the path used in the config option (MBOOT /C).
  276.  
  277. ${SS}      - The use of this flag will disable the time stamp feature of
  278.              MultiBoot 3.0.
  279.  
  280. ** these flags, if used, must be in one of the first three line of MBOOT.CFG
  281.    also, if these flags are already set in the config, you don't need these.
  282.    These flags are basically for occasional use.  If you use one flag regularly
  283.    then use the /C config option to hard code it into the program.
  284.  
  285. ** added in Ver 2.1 ** these flags now toggle the flag.  Therefore, if you
  286.    have any flag configured as ON through the /C option, using that flag in
  287.    the config will turn it off.  Same with the /R Reboot flag on the command
  288.    line.  Kind of confusing, but once you get it set up, it works.
  289.  
  290. ** added in Ver 2.2 ** you can now manually change these flags when presented
  291.    with the choose menu by using the ALT-R (reboot) and ALT-C (copy path)
  292.    keys to toggle flags.  As of version 3.06, you can click on the top status
  293.    line and toggle these flags with a mouse.
  294.  
  295. Shareware USER RESPONSIBILITIES
  296. -------------------------------
  297. - All users are granted permission to make as many copies of the
  298.   shareware program as required.
  299. - There are no restrictions on how many different computers one user may
  300.   evaluate the shareware MultiBoot.
  301. - Copies may be distributed to others as long as the following
  302.   requirements are met:
  303.   -- All three files, MBOOT.DOC, MBOOT.EXE, and MBOOT.CFG are transferred as
  304.      a whole.
  305.   -- These programs must be distributed free of cost.  Only the cost of the
  306.      media (e.g. diskette) can be charged.
  307.   -- The files are not modified in any way.
  308.   -- Only the shareware version is distributed.
  309.  
  310. - The author encourages comments.  Please leave comments, suggestions, or
  311. suggested modifications in a message on Who's Board BBS (503-747-0248)
  312. or to DAMION HAUX on the RIME PROGRAMMING conference, or write to
  313.   +-----------------------+
  314.   |  DAMION HAUX          |
  315.   |  576 E. 16th          |
  316.   |  EUGENE, OR 97401     |
  317.   +-----------------------+
  318. or send Fido netmail to 1:152/8.2. @ (503)345-7514 (Rhinoceros Kitchen)
  319.  
  320. DISCLAIMER OF WARRANTIES AND LIMITATION OF LIABILITIES
  321. ------------------------------------------------------
  322. The author has taken due care in writing this program, and the program is
  323. supplied as is.  The author makes no expressed or implied warranty of any
  324. kind with regard to this program.  In no event shall the author be liable
  325. for incidental or consequential damages in connection with or arising out
  326. of the use of this program.
  327.  
  328. PROGRAM INFOMATION
  329. ------------------
  330. MBOOT was written in Microsoft QUICK C Ver 2.0, originally.  It has
  331.    been transferred to Turbo C++ Ver 1.0, and uses the
  332.    TCXL library Ver 5.52 (c) Innovative Data Concepts,
  333.    a modified standard library, and lot's of time.
  334.  
  335. UPDATE HISTORY
  336. --------------
  337.     Ver 1.0b----  11-26-90
  338.         First release.
  339.     Ver 1.1b----  11-28-90
  340.         Fixed some obvious problems, added /r(eboot) option,
  341.         added ${ND} and ${AR} flags.
  342.     Ver 1.2b----  11-29-90
  343.         Fixed command line parsing, added reboot abort option,
  344.         parameters allowed in any order.
  345.     Ver 1.3b----  12-01-90
  346.         Never made it out my modem.  Restructured the whole
  347.         program, reducing it from 2 runs through the config
  348.         file to one.  Added capabilities for up to 100 configs.
  349.     Ver 1.4b----  12-09-90
  350.         Added ${UM} flag, removed F1 help and just included
  351.         HELP.DOC.  Saved some space and speed.
  352.     Ver 1.5b----  12-16-90
  353.         Added ${CC} flag, MBOOT will now look for the MBOOT.CFG
  354.         in it's directory, instead of the current directory.  The
  355.         ${CC} flag causes the configs to be copied to C:\ whether
  356.         the MBOOT files are there or not.  Added the /M option
  357.         which presents a bootup menu.
  358.      Ver 1.6b---- 12-18-90
  359.         Changed the ${ND} No default flag to ${UD} Use default flag.
  360.         Now the program will only use the default if the flag is there
  361.         as opposed to only using it if the flag wasn't there.
  362.      Ver 2.0b---- 12-19-90
  363.         Added the configuration routines, now allows colors to be set
  364.         and flags to be permanently altered.  Config target directory
  365.         can be set also.
  366.      Ver 2.1b---- 12-20-90
  367.         Small change.  Flags now TOGGLE state instead of just turning
  368.         options on.  Also, default color settings are shown in setup
  369.         screen.
  370.      Ver 2.2b----  1-22-91
  371.         Added status line at top to show flag status.  Also added the
  372.         ALT key combinations for manual changing of the flags.
  373.      Ver 3.0b----  4-25-91
  374.         Built in editor added.
  375.         Delete and Insert functions added in selection screen.
  376.         Global config and autoexec lines included.
  377.         {SS} flag added and time stamp feature.
  378.         Number of configs restricted to 20 for non-registered version,
  379.         100 for registered.
  380.      Ver 3.03b---- 5-9-91
  381.         Built in editor removed, and user-defined editor implemented.
  382.         Help line at bottom of selection screen added.  Program now
  383.         uses two temporary disk files to do editing instead of two
  384.         static memory arrays.  The /T option was added at Ray Landers
  385.         suggestion.
  386.      Ver 3.05b----5-12-91
  387.         Added mouse button action on status line at bottom of window.
  388.      Ver 3.06b----5-14-91
  389.         Added mouse button action on top line of window.  Added temp path
  390.         to config.  This is where temporary files are created when you
  391.         edit a config.  Also added the ability to have a config always
  392.         reboot by adding a /r to the end of the name line.
  393.      Ver 3.10b----5-15-91
  394.         Minor changes.  First version distributed since version 1.5!!!
  395.      Ver 3.11----6-30-91
  396.         Added configurable reboot delay and option to back up old
  397.         config files.  Also gave up this silly beta naming stuff.
  398.         This is the real thing.
  399.      Ver 3.12-----7-18-91
  400.         Added direct typing in of config number, and configurable reboot
  401.         program if the built in one doesn't work right.
  402.      Ver 3.13-----7-21-91
  403.         Added built in cold boot, and allowed choice between Cold, Warm, or
  404.         custom boot.  Knocked unregistered version down from 20 configs to 15.
  405.      Ver 3.20-----11-5-91
  406.         Fixed a small problem with the global lines being copied despite
  407.         comment marker.  Added the ability to dupe a config.  Added some more
  408.         streamlined .ASM code.
  409.  
  410.  
  411. Thanks to the Betas : Ray Landers, Tam Davage, Jim Miller, Rick Johnson
  412.  
  413. -------------------------------------------------------------------------
  414.         (c)1990, 1991 Programming Constructs - Damion Haux
  415.  
  416.